home *** CD-ROM | disk | FTP | other *** search
/ EuroCD 3 / EuroCD 3.iso / Programming / Python-1.4 / README < prev    next >
Text File  |  1998-06-24  |  6KB  |  190 lines
  1.  
  2.  
  3.                            PYTHON 1.4 RELEASE 2
  4.                           NOTES ON THE AMIGA PORT
  5.  
  6.                              January 31, 1998.
  7.  
  8.     
  9.            Conversion and Amiga specific code by Irmen de Jong.
  10.               (Original code by Guido van Rossum and others)
  11.  
  12.  
  13.  
  14.                    Read the file <DISCL_and_COPYRIGHT>!
  15.  
  16.    It contains the disclaimer for this software, and copyright notices.
  17.  
  18.  
  19.  
  20.     Contents:
  21.     ~~~~~~~~~
  22.  
  23.     1. What's new?    
  24.     2. General remarks.
  25.     3. Troubleshooting.
  26.     4. Future.
  27.     5. Modification history.
  28.  
  29.  
  30. +----------------------+
  31. |                      |
  32. |  1. What's new?      |
  33. |                      |
  34. +----------------------+
  35.  
  36. IMPORTANT CHANGES SINCE THE PREVIOUS VERSION (version 1.4 Jan 12 1997):
  37.  
  38.     - Included the bugfixes which were available as a patch file, see below.
  39.     - Some minor other fixes and changes.
  40.     - Distributing the source code along with this archive.
  41.       Look for `Python14_Src.lha' in the same place.
  42.     - Recompiled with SAS/C 6.58.
  43.  
  44.   Fixed bugs:
  45.     - possible enforcer hit or crash at exit (caused by wrong mempools code)
  46.     - roundoff errors in mathmodule. random.py works again
  47.     - readlink code (os.readlink) now works correctly
  48.  
  49.  
  50. +----------------------+
  51. |                      |
  52. |  2. General remarks  |
  53. |                      |
  54. +----------------------+
  55.  
  56. * All tests in Lib/test ran successfully with my version.
  57.   To try it yourself, type (after installation):
  58.   cd Python:lib/test
  59.   //Python -c "import autotest"  (and have patience...)
  60.   //Python -c "import autotest"  (and have patience...)
  61.   (Yes: do it TWICE because the generated .pyc files need to be checked too).
  62.   Both runs should report 'all tests OK'.
  63.  
  64. * To  see  some  command  line  options,  use  the -?  option, or any other
  65.   unrecognised option.
  66.  
  67. * The  `Docs'  directory  contains  2 text files regarding regular expression
  68.   syntax,  and  some  other  documents.   You might want to copy other python
  69.   documentation in here.
  70.  
  71. * In the `Docs/Amiga' directory you can find the docs for the Amiga specific
  72.   modules and features. Read them, they contain vital information!
  73.  
  74. * In the `Icons' directory there are some icon suggestions.
  75.   def_py.info is an icon for Python source files (.py)
  76.   def_pyc.info is an icon for Pytnon bytecode files (.pyc)
  77.  
  78. * The following modules are built-in in this release:
  79.     amiga        arexxll        array        binascii
  80.     cmath        crypt        doslib        environment
  81.     errno        grp        imp        marshal
  82.     math        md5        new        operator
  83.     pwd        regex        rotor        select
  84.     socket        soundex        strop        struct
  85.     sys        syslog        time        timing
  86.     urlop
  87.  
  88.   Amiga specific: amiga, arexxll, doslib, environment
  89.   Needs usergroup.library: crypt, grp, pwd.
  90.   Needs AmiTCP's bsdsocket.library: select, socket, syslog.
  91.  
  92. * Mail  me  if  you encounter any Amiga specific problems, or if you have any
  93.   Amiga  related  questions  about  Python,  or  just  for fun.  General
  94.   questions are better asked on the usenet newsgroup comp.lang.python.  A lot
  95.   of   information,   including  an  online  manual,  can  be  obtained  from
  96.   <http://www.python.org/>,  or  <http://www.cwi.nl/www.python.org/>  if  your
  97.   site is close to the Netherlands.  Read the FAQ before asking!
  98.  
  99. * Version 1.3 is no longer supported by me. Please upgrade to 1.4.
  100.  
  101. * Version 1.5 has already been released.  Amiga Python 1.5 is at the time
  102.   of writing in beta. 
  103.  
  104.  
  105. +-----------------------+
  106. |                       |
  107. |  3. Troubleshooting   |
  108. |                       |
  109. +-----------------------+
  110.  
  111. * When  I  try  to  install  Python,  I  get  "Unable  to  open  your tool
  112.   'installer'"!
  113.  
  114.   The Installer® utility is required for installation, but it is not included
  115.   in  the  archive.   Get  it  from  somewhere  else  and  copy it to your C:
  116.   directory or somewhere where Workbench can find it.
  117.  
  118. * When I start python, I get "This program requires a math co-processor"!
  119.  
  120.   You have installed the wrong version. Pick the one with IEEE math.
  121.  
  122. * Python seems so slow!
  123.  
  124.   This  is  because Python is an interpreted language.  Some programs execute
  125.   slow because of this.  Other programs can run fast, because they are written
  126.   better, or make heavy use of the fast built-in (compiled) modules. Keep in
  127.   mind that function calls in Python have quite big overhead.
  128.  
  129. * I   get   "Couldn't   open   bsdsocket.library"   or   "Couldn't   open
  130.   usergroup.library" errors!
  131.  
  132.   You  are  trying to use functions that need one of these libraries.  AmiTCP
  133.   is required if you want to use all (network) functions.
  134.  
  135. * Python crashes when executing complex (recursive) code!
  136.  
  137.   This should not happen; you should get a MemoryError exception.  If it does
  138.   crash, increase your stack size and try again.  Python's default stack size
  139.   is 20K, which should be enough for most programs.
  140.  
  141. * Functions which use the PIPE: device (like os.popen) seem to work
  142.   incorrectly!
  143.  
  144.   The default l:queue-handler is buggy.  Make sure you have installed a fixed
  145.   l:queue-handler (I'm using util/sys/HWGQueue.lha from Aminet)
  146.  
  147. * Other errors
  148.  
  149.   Mail me at ijong@gak.nl with a clear description of the problem.
  150.  
  151.  
  152. +----------------------+
  153. |                      |
  154. |  4. Future           |
  155. |                      |
  156. +----------------------+
  157.  
  158. A bunch of ideas which might be implemented someday in the future:
  159.    - interfaces to other Amiga libraries
  160.    - GUI module for building python apps with a GUI
  161.    - Support for other networking packages like I-Net
  162.    - Use Executive's API (sysinfo.library, if available) for process stuff?
  163.    - split python in several shared libraries
  164.    - bugfixes (are there any bugs? Let me know)
  165.  
  166.  
  167. +---------------+
  168. |               |
  169. |  5. History   |
  170. |               |
  171. +---------------+
  172.  
  173.  
  174. dec. 1995 to dec 1996: version 1.3 releases. History stripped.
  175. 1.3 is no longer supported.
  176.  
  177. 12 jan. 1997    - 1st public release of version 1.4
  178.           Some minor additional changes since 1.3.
  179.           Includes doslib & ARexx support.
  180.  
  181. 31 jan. 1998    - 2nd public release of version 1.4
  182.           Some minor changes. Included patches.
  183.           (version 1.5 is in beta).
  184.  
  185.  
  186.  
  187.                     Irmen de Jong
  188.                     (ijong@gak.nl)
  189.  
  190.